Skip to main content
高仙开放平台
概述
接口文档
发布动态
高仙工具下载
进入开发者中心

发布动态

Hotfix (2025-05-20)

描述: 修复任务报告 V2 接口中 mapId 字段缺失的问题。

内容:

  1. 修复了自 2025 年 5 月 15 日起，任务报告 V2 接口返回结果中 mapId 字段缺失的问题；
  2. 修复完成后，重新查询 2025 年 5 月 15 日及之后的任务报告，将能正常获取 mapId 字段数据。

Feature (2025-05-15)

描述: 推送机制升级，问题修复

内容:

  1. 推送机制升级
  • 详细信息：
    • 统一事件/任务报告/排班任务的配置与推送逻辑
    • 增加根据集团客户推送支持
    • 增加新的返回数据格式，自2025年5月15日后发生订阅的会产生变更
      • 之前已生效推送保持现状，不会变化格式
      • 原有的appId与payload字段继续保持不变
      • 新增的字段如下
        • messageTypeId: 推送类型，1事件，2任务报告，3排班任务
        • productId: 机器人SN
        • messageId: 推送全局唯一ID，格式为{productId}:{messageTypeId}:{businessId}
        • traceId: 请求跟踪ID
        • messageTimestamp: 推送发起的时间戳，单位ms
  1. 问题修复
  • 详细信息：
    • 修复任务报告查询v2接口，不兼容历史版本（4年前）梯控任务报告查询问题

Feature (2025-04-28)

描述: 新功能和优化

内容:

  1. 查询机器人列表API新增字段
  • 详细信息：
    • 在机器人信息查询获取机器人列表接口中引入软件版本信息（softwareVersion）。

Feature (2025-04-10)

描述: 云梯控对接接口协议 V1.4

内容:

  1. 新增电梯控制系统接口协议 V1.4
  • 新增以下电梯控制相关接口：
    • OAuth 2.0 客户端凭证授权流程获取访问令牌
    • WebSocket 连接创建
    • 电梯配置信息获取
    • 电梯预约
    • 呼叫电梯到出发区域
    • 呼叫电梯到目的地区域
    • 取消电梯使用
    • 请求保持电梯门开启
    • 请求关闭电梯门
    • 订阅电梯运行状态请求
    • 订阅电梯运行模式请求
  1. 完善接口文档
  • 所有接口包含详细的请求示例和响应示例
  • 提供完整的错误码说明
  • 每个接口提供详细的功能描述

Feature (2025-03-28)

描述: 新功能和优化

内容:

  1. 事件推送服务增强
  • 详细信息：
    • 在事件推送服务中引入导航相关的信息（navInstanceId，pointName）。
    • 适用版本： 对于 aio1.4 hotfix12及之后的版本，数据将基于实时机器人状态。
  1. 任务报告推送服务增强
  • 详细信息：
    • 在任务报告推送服务中引入分区名称列表的信息（areaNameList）。
    • 适用版本： aio1.1版本之后，展示分区名称列表；规则：floorname1_areaname11...,floorname2_areaname21_areaname22...,...
  1. V2 列出机器人任务报告查询逻辑增强
  • 影响 API： /openapi/v2alpha1/robots/*/taskReports
  • 详细信息：
    • 在任务报告查询中引入分区名称列表的信息（areaNameList）。
    • 适用版本： aio1.1版本之后，展示分区名称列表；规则：floorname1_areaname11...,floorname2_areaname21_areaname22...,...
  1. V1 列出机器人任务报告查询逻辑增强
  • 影响 API： /openapi/v1alpha1/robots/*/taskReports
  • 详细信息：
    • 在任务报告查询中引入分区名称列表的信息（areaNameList）。
    • 适用版本： aio1.1版本之后，展示分区名称列表；规则：floorname1_areaname11...,floorname2_areaname21_areaname22...,...
  1. V1 获取机器人状态查询逻辑增强
  • 影响 API： /openapi/v1alpha1/robots/*/status
  • 详细信息：
    • 在机器人状态查询中引入导航状态、梯控状态的信息（navStatus、currentElevatorState）。
    • 适用版本： aio1.1版本之后
  1. V1 批量获取机器人状态查询逻辑增强
  • 影响 API： /openapi/v1alpha1/robots/*/status:batchGet
  • 详细信息：
    • 在批量机器人状态查询中引入导航状态、梯控状态的信息（navStatus、currentElevatorState）。
    • 适用版本：aio1.1版本之后
  1. V2 获取 S 机器人状态查询逻辑增强
  • 影响 API： /openapi/v2alpha1/robots/*/status
  • 详细信息：
    • 在机器人状态查询中引入导航状态、梯控状态的信息（navStatus、currentElevatorState）。
    • 适用版本：aio1.1版本之后
  1. V2 批量获取 S 机器人查询逻辑增强
  • 影响 API： /openapi/v2alpha1/robots/*/status:batchGet
  • 详细信息：
    • 在批量机器人状态查询中引入导航状态、梯控状态的信息（navStatus、currentElevatorState）。
    • 适用版本：aio1.1版本之后
  1. 获取机器人指令查询逻辑增强
  • 影响 API： /v1alpha1/robots/*/commands/
  • 详细信息：
    • 在批量机器人状态查询中引入导航实例id、任务实例id的信息（taskQueueId、navInstanceId）。
    • 适用版本：aio1.1版本之后支持查询任务实例id的信息，aio1.4 hotfix12及之后的版本支持查询导航实例id的信息。

Feature (2024-12-12)

描述: 新功能和优化

内容:

  1. 事件推送服务增强
  • 详细信息：
    • 在事件推送服务中重新引入与机器人相关的信息（mapId，mapName）。
    • 注意： 此数据为模拟数据，基于近似的机器人状态推导，而非实际数据。
    • 适用版本： 适用于 aio1.3hotfix9 之前的版本。对于 aio1.3hotfix9 及之后的版本，数据将基于实时机器人状态。
  1. 任务报告查询逻辑优化
  • 影响 API： /openapi/v2alpha1/robots/*/taskReports
  • 优化内容：
    • 引入以下时间范围参数优化查询逻辑：
      • startTimeMin / startTimeMax：定义任务开始时间的最小值和最大值。
      • endTimeMin / endTimeMax：定义任务结束时间的最小值和最大值。
    • 影响：
      • 解决了之前查询逻辑中的问题。
      • 提升了任务报告查询的灵活性和准确性。
  1. 机器人状态 API 增强
  • 影响 API： /openapi/v2alpha1/s/robots/{robot}/status
  • 增强内容：
    • 部署点坐标：
      • 添加了 navigationPoints，包含部署点的 x 和 y 坐标，支持机器人移动后的状态评估。
      • 建议： 使用 GIS Distance 方法评估坐标。
      • 适用版本： 适用于 aio1.4hotfix1 之前的版本（配合 Phantas）。对于 aio1.4hotfix1 及之后的版本，数据将基于实时机器人状态。
    • 设备/耗材信息：
      • 新增了对与机器人相关设备和耗材的监控支持，包括：
        • 充电电流
        • 空气过滤器状态
        • 清水过滤器状态

Feature (2024-09-26)

描述: 整体优化相关接口文档的描述，使之更容易被接受和理解，增加新的相关设备的地图信息和地图的分区域信息

内容:

  1. 增加所有接口的调用示例（Demo）
    我们为每个API接口新增了详细的调用示例，帮助开发者更好地理解和使用API。这些示例包括请求载荷（payload）和相应的响应示例。
  2. 新增获取机器人地图列表与站点区域获取接口
    我们新增了两个与机器人地图相关的接口，以增强地图功能的交互性：
    /openapi/v1/map/robotMap/list: 该接口用于获取机器人使用的地图列表，包括地图ID、地图名字的信息数据。
    /openapi/v1/map/subareas/get: 该接口用于获取机器人地图中的分区信息，为需要更精确的机器人区域操作的服务提供了更大的细粒度控制。
  3. 调整 M/S 临时任务下发流程描述
    我们对M线/S 的机器人临时任务下发接口的流程描述进行了调整，以提高接口的可读性。

Feature (2024-08-15)

描述: 设备状态&事件推送服务增强&任务报告查询及推送服务增强

内容:

  1. 机器人状态变更
    新增内容：机器人状态接口已更新包括各类设备状态及其耗材寿命设备包括：滚刷、盘刷、左边刷、右边刷、软胶吸水扒、滚轮吸水扒、普通尘推、滚动尘推、过滤器、水阀
  2. V2任务报告获取 和 任务推送变更
    新增字段：以下字段已添加到 V2_ListRobotTaskReports 和 TaskReportPush 接口中。taskId（预部署组合任务ID）、planId（排班计划ID）、subTaskId（子任务ID）
  3. 事件推送服务变更
    新增字段：IncidentPush 接口现在包含以下字段：taskId（预部署组合任务ID）、subTaskId（子任务ID）、taskInstanceId、taskName、mapId、mapName
    数据源变更：这些字段的数据源已从数据拟合切换为机器端上报可能存在版本回退的情况在 AIO1.3 hotfix 之前这些字段可能为空
    事件代码更新：对于事件代码 50001 和 50002推送消息中的事件名称将包含任务名称

Feature (2024-07-01)

描述: 事件推送服务增强

内容: 在事件推送服务中增加了聚合信息字段，包括事件发生时的机器人所在地图和任务名称等。这些新增字段为客户提供了更加全面的任务背景信息，使得事件推送更加有价值，帮助客户更好地理解和管理机器人的运行状态。

Hotfix (2024-05-27)

描述: 任务恢复能力优化

内容: 针对非AIO版本的Phantas，优化了其任务恢复能力。该优化提高了在非一体化系统环境下任务的可靠性和连续性，确保了任务执行的稳定性。

Feature (2024-05-06)

描述: 事件推送服务优化

内容: 优化了事件推送服务，打通了用户事件订阅和服务事件推送服务的数据关联关系。此改进使得用户能够更有效地订阅和管理各类事件通知，提升了事件处理的效率和用户体验。

Feature (2024-04-26)

描述: 新的任务报告接口

内容: 新增了任务报告接口v2alpha1/ListRobotTaskReports。该接口提供了更优的用户使用功能，使得用户能够更详细地获取和分析机器人的任务报告数据，从而提升了数据的可视化和决策支持能力。

Feature (2024-03-21)

描述: 无站点临时任务下发通道

内容: 增加了Phantas无站点临时任务下发通道（SendTempTaskCommand）。这一功能使得客户可以灵活地对机器人发布临时任务，无需依赖预先定义的站点，从而提升了任务调度的灵活性和效率。

Hotfix (2024-03-11)

描述: 初始化坐标类型优化

内容: 针对机器人移动指令在云端大小写导致的bug进行了修复，将初始化坐标类型从double优化为int。这一修复解决了因数据类型不匹配而引发的指令执行异常问题，确保了机器人移动的精准性和稳定性。

Feature (2023-12-22)

描述: 事件推送服务

内容: 新增任务开始推送和任务结束推送功能，使得客户可以更加清晰地了解机器人任务执行的动态变化。这一改进不仅增强了任务状态的可见性，也提高了客户对任务进程的掌握程度，从而能够更及时地进行相应的业务调整。